home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmInstallImage.z / XmInstallImage
Encoding:
Text File  |  2003-11-18  |  4.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmIIIInnnnssssttttaaaallllllllIIIImmmmaaaaggggeeee((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        XXXXmmmmIIIInnnnssssttttaaaallllllllIIIImmmmaaaaggggeeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_I_n_s_t_a_l_l_I_m_a_g_e - A pixmap caching function that adds an
  10.       image    to the pixmap cache
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <Xm/Xm.h>
  14.  
  15.       Boolean XmInstallImage (iiiimmmmaaaaggggeeee,,,, iiiimmmmaaaaggggeeee____nnnnaaaammmmeeee)
  16.            _X_I_m_a_g_e     **** iiiimmmmaaaaggggeeee;
  17.            _c_h_a_r     **** iiiimmmmaaaaggggeeee____nnnnaaaammmmeeee;
  18.  
  19.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.       _X_m_I_n_s_t_a_l_l_I_m_a_g_e stores    an image in an image cache that    can
  21.       later    be used    to generate a pixmap.  Part of the
  22.       installation process is to extend the    resource converter
  23.       used to reference these images.  The resource    converter is
  24.       given    the image name so that the image can be    referenced in
  25.       a .Xdefaults file.  Since an image can be referenced by a
  26.       widget through its pixmap resources, it is up    to the
  27.       application to ensure    that the image is installed before the
  28.       widget is created.
  29.  
  30.       iiiimmmmaaaaggggeeee
  31.            Points to the image structure to    be installed.  The
  32.            installation process does not make a local copy of the
  33.            image.  Therefore, the application should not destroy
  34.            the image until it is uninstalled from the caching
  35.            functions.
  36.  
  37.       iiiimmmmaaaaggggeeee____nnnnaaaammmmeeee
  38.            Specifies a string that the application uses to name
  39.            the image.  After installation, this name can be    used
  40.            in .Xdefaults for referencing the image.     A local copy
  41.            of the name is created by the image caching functions.
  42.  
  43.       The image caching functions provide a    set of eight
  44.       preinstalled images.    These names can    be used    within a
  45.       ._X_d_e_f_a_u_l_t_s file for generating pixmaps for the resource for
  46.       which    they are provided.
  47.  
  48.        IIIImmmmaaaaggggeeee NNNNaaaammmmeeee      DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  49.        ____________________________________________________________
  50.        background      A tile of solid background
  51.        25_foreground   A tile of 25% foreground, 75% background
  52.        50_foreground   A tile of 50% foreground, 50% background
  53.        75_foreground   A tile of 75% foreground, 25% background
  54.        horizontal      A tile of horizontal lines of the two colors
  55.        vertical           A tile of vertical lines    of the two colors
  56.        slant_right     A tile of slanting lines    of the two colors
  57.        slant_left      A tile of slanting lines    of the two colors
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmIIIInnnnssssttttaaaallllllllIIIImmmmaaaaggggeeee((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        XXXXmmmmIIIInnnnssssttttaaaallllllllIIIImmmmaaaaggggeeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  75.       Returns True when successful;    returns    False if NULL iiiimmmmaaaaggggeeee,
  76.       NULL iiiimmmmaaaaggggeeee____nnnnaaaammmmeeee, or duplicate    iiiimmmmaaaaggggeeee____nnnnaaaammmmeeee is used as a
  77.       parameter value.
  78.  
  79.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  80.       _X_m_U_n_i_n_s_t_a_l_l_I_m_a_g_e(_3_X),    _X_m_G_e_t_P_i_x_m_a_p(_3_X), and
  81.       _X_m_D_e_s_t_r_o_y_P_i_x_m_a_p(_3_X).
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.